home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / intro.z / intro
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. iiiinnnnttttrrrroooo((((3333GGGG))))                                                            iiiinnnnttttrrrroooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiinnnnttttrrrroooo - description of routines in the Graphics Library and Distributed
  10.      Graphics Library
  11.  
  12. OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW
  13.      This manual is the reference manual for the routines of the Graphics
  14.      Library (GL).  For a more tutorial introduction to the GL, see the
  15.      _G_r_a_p_h_i_c_s _L_i_b_r_a_r_y _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e.
  16.  
  17.      In general, all routines in the GL can run either on a local IRIS host,
  18.      or on a remote host connected through a network to an IRIS host, to
  19.      perform graphics operations on an IRIS graphics display.  The
  20.      capabilities of some routines vary between different IRIS graphics
  21.      architectures, or between local and remote operation.  Such differences
  22.      are noted on these routines' manual pages.
  23.  
  24.      When a manual page refers to VGX, unless it is stated otherwise, it
  25.      applies to VGX, VGXT, and SkyWriter graphics. Similarly, a reference to
  26.      Personal Iris applies to Personal Iris G and TG graphics, and a reference
  27.      to Elan graphics subsystem or Elan graphics architecture applies to XS,
  28.      XS24, XZ, Elan and Extreme.  Also, references to RealityEngine should
  29.      also apply to VTX and RealityEngine2.
  30.  
  31.      The manual pages are available on-line.  To view them, use the IRIX
  32.      command:
  33.  
  34.           man _r_o_u_t_i_n_e-_n_a_m_e <Enter>
  35.  
  36.  
  37. HHHHOOOOWWWW TTTTHHHHIIIISSSS MMMMAAAANNNNUUUUAAAALLLL IIIISSSS OOOORRRRGGGGAAAANNNNIIIIZZZZEEEEDDDD
  38.      A manual page provides reference information for a routine of the GL.
  39.      Because these pages are intended as on-line reference material, they tend
  40.      to be terse.  A page is divided into a number of sections:
  41.  
  42.      NNNNAAAAMMMMEEEE lists the name of the routine or routines described by the manual
  43.           page.
  44.  
  45.      CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  46.           lists the type declarations for the routine and its parameters.
  47.  
  48.      PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  49.           describes the parameters of the routine.
  50.  
  51.      FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  52.           describes what the routine returns if it is a function.
  53.  
  54.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  55.           describes how to use the routine.
  56.  
  57.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  58.           lists related routines or other sources of information.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiinnnnttttrrrroooo((((3333GGGG))))                                                            iiiinnnnttttrrrroooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  75.           gives an example of how the routine is used.
  76.  
  77.      NNNNOOOOTTTTEEEESSSS
  78.           highlights information concerning the limitations of the routine and
  79.           differences in its behavior on the various IRIS-4D models.
  80.  
  81.      BBBBUUUUGGGGSSSS describes deviations from the specified behavior that may be fixed
  82.           in a future release.
  83.  
  84. TTTTYYYYPPPPEEEE DDDDEEEECCCCLLLLAAAARRRRAAAATTTTIIIIOOOONNNNSSSS
  85.      We have constructed type declarations for C wherever they add to the
  86.      readability of the code.  Here are the type definitions as found in
  87.      <_g_l/_g_l._h>:
  88.  
  89.           #define PATTERN_16 16
  90.           #define PATTERN_32 32
  91.           #define PATTERN_64 64
  92.           #define PATTERN_16_SIZE 16
  93.           #define PATTERN_32_SIZE 64
  94.           #define PATTERN_64_SIZE 256
  95.  
  96.           typedef unsigned char Byte;
  97.           typedef long Boolean;
  98.           typedef char *String;
  99.           typedef short Angle;
  100.           typedef short Screencoord;
  101.           typedef short Scoord;
  102.           typedef long Icoord;
  103.           typedef float Coord;
  104.           typedef float Matrix[4][4];
  105.  
  106.           typedef unsigned short Colorindex;
  107.           typedef unsigned char RGBvalue;
  108.  
  109.           typedef unsigned short Device;
  110.  
  111.           typedef unsigned short Linestyle;
  112.           typedef unsigned short Cursor[16];
  113.  
  114.           typedef unsigned short Pattern16[PATTERN_16_SIZE];
  115.           typedef unsigned short Pattern32[PATTERN_32_SIZE];
  116.           typedef unsigned short Pattern64[PATTERN_64_SIZE];
  117.  
  118.           typedef struct {
  119.                unsigned short offset;
  120.                Byte w,h;
  121.                char xoff,yoff;
  122.                short width;
  123.           } Fontchar;
  124.  
  125.           typedef long Object;
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiinnnnttttrrrroooo((((3333GGGG))))                                                            iiiinnnnttttrrrroooo((((3333GGGG))))
  137.  
  138.  
  139.  
  140.           typedef long Tag;
  141.           typedef long Offset;
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.